home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 January: Mac OS SDK / Dev.CD Jan 98 SDK1.toast / Development Kits (Disc 1) / MacTCP / TCP⁄IP Administration.image / TCP_IP Administration.image / Mac System MIB < prev    next >
Encoding:
Text File  |  1994-05-12  |  26.7 KB  |  1,029 lines  |  [TEXT/ttxt]
  1. M.Ritter/G.Holzhauer/V.Lubet
  2.  
  3. Apple IP Working Group     Apple Computer, Inc. 
  4.  
  5. Macintosh System Management Information Base
  6.  
  7. Version 1.1 , May 12, 1994
  8.         Corrects the code of the trap userInTRouble. 
  9.         Now is 1 as implemented by MacSNMP (was 0)
  10.  
  11. Status of this memo
  12.  
  13. This document is an Internet Draft. Internet Drafts are working 
  14. documents of the Internet Engineering Task Force (IETF), its Areas, and its 
  15. Working Groups. Note that other groups may also distribute working 
  16. documents as Internet Drafts.
  17.  
  18. Internet Drafts are draft documents valid for a maximum of six 
  19. months. Internet Drafts may be updated, replaced, or obsoleted by other 
  20. documents at any time. It is not appropriate to use Internet Drafts as 
  21. reference material or to cite them other than as a "working draft" or "work 
  22. in progress."
  23.  
  24. Please check the I-D abstract listing contained in each Internet 
  25. Draft directory to learn the current status of this or any other Internet 
  26. Draft.
  27.  
  28. This draft document will be submitted as an informational RFC 
  29. describing an enterprise-specific extension to the SNMP MIB. Distribution 
  30. of this memo is unlimited. Please send comments to the author.
  31.  
  32. Table of Contents
  33.  
  34. 1. Abstract........................................................1
  35. 2. Historical perspective..........................................2
  36. 3. Objects.........................................................2
  37. 4. Overview........................................................2
  38. 4.1 Structure of the Macintosh MIB.................................2
  39. 4.2 The System Group...............................................3
  40. 4.3 The Software Group.............................................3
  41. 4.4 The Hardware Group.............................................3
  42. 5. Textual conventions.............................................3
  43. 6. Definitions.....................................................4
  44. 7. Acknowledgments.................................................18
  45. 8. References......................................................19
  46. 9. Author's address................................................20
  47.  
  48.  
  49. 1. Abstract
  50.       
  51. This memo defines an enterprise-specific portion of the Management
  52. Information Base (MIB) [1] for use with the Simple Network Management
  53. Protocol (SNMP) [3]. In particular, it defines objects for managing
  54. Macintosh computers.  
  55.  
  56.  
  57. 2. Historical Perspective
  58.  
  59. Consistent with the Internet Activities Board directive to produce simple, 
  60. workable systems in the short term, the list of managed objects defined in 
  61. the Internet-standard MIB [2] was derived by taking only those elements 
  62. that were considered essential. However, the SMI [1] defined three 
  63. extensibility mechanisms: one, the addition of new standard objects through 
  64. the definitions of new versions of the MIB; two, the addition of widely 
  65. available but nonstandard objects through the experimental subtree; and 
  66. three, the addition of private objects through the enterprises subtree. 
  67. Such additional objects can be used not only for vendor-specific elements, 
  68. but also for experimentation as required to further the knowledge of which 
  69. other objects are essential.
  70.  
  71. This memo defines extensions to the MIB using the third method. It contains 
  72. definitions of managed objects specific to one enterprise.
  73.  
  74.  
  75. 3. Objects
  76.  
  77. Section 6 contains the specification of all object types contained in this 
  78. MIB module. The object types are defined using the conventions defined in 
  79. the SMI, as amended by the extensions specified in [4, 5].
  80.  
  81.  
  82. 4. Overview
  83.  
  84. The Macintosh is a personal computer designed and sold by Apple Computer, 
  85. Inc. It is shipped with built-in networking using Localtalk and/or 
  86. EtherTalk [6] and has the ability to support almost any networking hardware 
  87. [7]. Thus, it is commonly connected into large networks and a method to 
  88. manage these computers on these networks becomes necessary. Since Macintosh 
  89. computers are commonly on multivendor networks that coexist with large IP 
  90. networks, it is natural to use SNMP to provide the network management 
  91. required. This MIB defines managed objects to be used for managing 
  92. Macintosh personal computers on networks using SNMP.
  93.  
  94. 4.1.  Structure of the Macintosh MIB
  95.  
  96. The objects are arranged into the following groups:
  97.  
  98.     - System
  99.         General
  100.         MIBs
  101.         Trap Configuration
  102.     - Software 
  103.         General
  104.         Printer
  105.         System Folder
  106.         Applications
  107.     - Hardware
  108.         General
  109.         Nubus
  110.         SCSI
  111.         Volumes
  112.  
  113. 4.2 The System Group
  114.  
  115. The System Group identifies the Macintosh computer. It identifies what MIBs 
  116. are supported. It also holds a table for trap configuration. Using this 
  117. table, an SNMP management console can configure the Macintosh computer with 
  118. the destination address of a console that wants to receive traps from the 
  119. Macintosh computer.
  120.  
  121. 4.3 The Software Group 
  122.  
  123. The Software Group identifies the versions of software provided with every 
  124. machine. It does this by implementing an SNMP interface to the Gestalt 
  125. Manager [9]. It also identifies the chosen printer. It provides a list of 
  126. files in the System Folder and all of its subfolders. This allows 
  127. management of files that can modify system software. Finally, it provides a 
  128. list of all of the applications on the system. This allows management of 
  129. site-licensed software.
  130.  
  131. 4.4 The Hardware Group
  132.  
  133. The Hardware Group describes the physical parts of the Macintosh computer. 
  134. It lists the hardware ports available. It describes each expansion card 
  135. plugged into the NuBus and each device plugged into the SCSI bus. It also 
  136. lists every mounted volume. It does not contain things that can be 
  137. determined from the Gestalt interface in the Software Group.
  138.  
  139.  
  140. 5. Textual Conventions
  141.  
  142. In the past, there have been misinterpretations of the MIB as to when a 
  143. string of octets should contain printable characters, meant to be 
  144. displayed to a human. As a textual convention in the MIB, the data type 
  145. DisplayString was introduced [2]. A DisplayString is restricted to the NVT 
  146. ASCII character set, as defined in pages 10-11 of [8]. This convention 
  147. is adequate for some countries and some MIBs. The Macintosh is, however, 
  148. sold worldwide and requires that human-readable strings be more flexible 
  149. than the NVT ASCII character set. Therefore, a new data type, 
  150. MacintoshDisplayString ::= OCTET STRING, has been defined. This data type
  151. is interpreted as a string to be displayed to a user and is not limited to 
  152. the NVT ASCII character set. It is instead defined by Appendix D in [6]. 
  153.  
  154. A common type used to name things on the Macintosh is a 32-bit integer 
  155. with each of its four octets consisting of a character (usually NVT ASCII) 
  156. that is used as a human-readable mnemonic. This type is used in the 
  157. Macintosh computer's Resource Manager as well as in the gestaltTable. A new 
  158. data type, MacOSType ::= INTEGER, has been defined. For purposes of display 
  159. only, this data type should be interpreted as four octets of a 
  160. MacintoshDisplayString. 
  161.  
  162. Finally, the Macintosh uses a 32-bit integer to represent a date in the 
  163. file system and many other places. A new data type has been defined, 
  164. MacDate ::= INTEGER, which should be interpreted as the number of seconds 
  165. since midnight, January 1, 1904, and names a particular date and time.
  166.  
  167. It should be noted that these changes have no effect on either the 
  168. syntax or semantics of any objects. The use of these definitions is 
  169. merely an artifact of the explanatory method used in the Macintosh MIB 
  170. and future MIBs.
  171.  
  172. 6. Definitions
  173.  
  174. Apple-Macintosh-System-MIB DEFINITIONS ::= BEGIN
  175.  
  176. IMPORTS
  177.     TRAP-TYPE
  178.         FROM RFC-1215
  179.     DisplayString
  180.         FROM RFC1213-MIB
  181.     OBJECT-TYPE
  182.         FROM RFC-1212
  183.     TimeTicks, enterprises, Counter
  184.         FROM RFC1155-SMI;
  185.  
  186.  
  187. -- Textual Conventions
  188.  
  189. -- MacOSType is an unsigned integer of four octets, which should be 
  190. -- interpreted as four characters to be displayed to a user. 
  191.  
  192.    MacOSType ::= INTEGER
  193.    
  194. -- MacDate is an unsigned integer of four bytes and is the number of 
  195. -- seconds since midnight, January 1, 1904.
  196.  
  197.    MacDate ::= INTEGER
  198.    
  199. -- MacintoshDisplayString is interpreted as a string to be displayed to a 
  200. -- user. 
  201.  
  202.     MacintoshDisplayString ::= OCTET STRING
  203.  
  204. -- Macintosh System MIB
  205.  
  206. apple         OBJECT IDENTIFIER ::= { enterprises 63 }
  207. macintosh     OBJECT IDENTIFIER ::= { apple 1 }
  208. experimental OBJECT IDENTIFIER ::= { apple 2 }
  209.  
  210. -- A user-generated trap
  211.  
  212. userInTrouble  TRAP-TYPE
  213. ENTERPRISE  apple
  214. VARIABLES   { snmpZone, snmpName, helpMsg }
  215. DESCRIPTION
  216. "A userInTrouble trap signifies that the sending SNMP 
  217. application's user is having some trouble using the network and 
  218. wishes to receive help from a knowledgeable network manager."
  219. ::= 1
  220.  
  221.  
  222. -- The Groups
  223.  
  224. system            OBJECT IDENTIFIER ::= { macintosh 1 }
  225. software        OBJECT IDENTIFIER ::= { macintosh 2 }
  226. hardware        OBJECT IDENTIFIER ::= { macintosh 3 }
  227.  
  228.  
  229. -- The System Group
  230.     
  231. snmpName OBJECT-TYPE
  232. SYNTAX MacintoshDisplayString
  233. ACCESS    read-only
  234. STATUS    mandatory
  235. DESCRIPTION
  236. "The name advertised over NBP with type 'SNMP Agent.' The 
  237. default is the same as the machine name set in the Sharing 
  238. Setup Control Panel. If there is no machine name, a random 
  239. unique name will be chosen." 
  240. REFERENCE
  241. "See 'Inside Macintosh' Vol. VI, Ch. 7." 
  242. ::= { system 1 }
  243.  
  244. snmpZone OBJECT-TYPE
  245. SYNTAX    MacintoshDisplayString (SIZE (1..32))
  246. ACCESS    read-only
  247. STATUS    mandatory
  248. DESCRIPTION
  249. "A text string that contains the zone name used to advertise 
  250. over NBP with type 'SNMP Agent.' The default is the local zone 
  251. name of the node."
  252. REFERENCE
  253. "See 'Inside Macintosh' Vol. VI, Ch. 7." 
  254. ::= { system 2 }
  255.  
  256. machineIcon  OBJECT-TYPE
  257. SYNTAX    OCTET STRING (SIZE (128))
  258. ACCESS    read-only
  259. STATUS    mandatory
  260. DESCRIPTION
  261. "A 32 x 32 pixel image of the Macintosh computer. The bits of 
  262. the first four octets are the pixels in right to left order as 
  263. the top row of the image. Ensuing four-octet groups are 
  264. interpreted as descending rows."
  265. REFERENCE
  266. "See 'Inside Macintosh' Vol. VI, Ch. 3."
  267. ::= { system 3 }
  268.  
  269. snmpPhone OBJECT-TYPE
  270. SYNTAX    MacintoshDisplayString (SIZE (1..32 ))
  271. ACCESS    read-only
  272. STATUS    mandatory
  273. DESCRIPTION
  274. "A text string that contains the phone number of a phone near 
  275. the Macintosh computer." 
  276. ::= { system 4 }
  277.  
  278. helpMessage  OBJECT-TYPE
  279. SYNTAX    MacintoshDisplayString (SIZE (1..255))
  280. ACCESS    read-only
  281. STATUS    mandatory
  282. DESCRIPTION
  283. "A text string that contains the message that the user wished 
  284. to send to a network manager." 
  285. ::= { system 5 }
  286.  
  287.  
  288. -- GroupIndex is a unique number assigned to each group registered 
  289.  
  290.     GroupIndex ::= INTEGER
  291.  
  292. -- AgentIndex is a unique number assigned to each agent registered 
  293.  
  294.     AgentIndex ::= INTEGER
  295.  
  296.  
  297. contentsTable  OBJECT-TYPE
  298. SYNTAX     SEQUENCE OF ContentsEntry
  299. ACCESS    not-accessible
  300. STATUS    mandatory
  301. DESCRIPTION
  302. "Contains information about agents and groups of variables 
  303. registered at this node."
  304. ::= { system 6 }
  305.  
  306. contentsEntry  OBJECT-TYPE
  307. SYNTAX     ContentsEntry
  308. ACCESS    not-accessible
  309. STATUS    mandatory
  310. DESCRIPTION
  311. "Each entry contains information about an agent or group that 
  312. has been registered at this node. The indexes are the 
  313. AgentIndex and GroupIndex, which are unique integers assigned 
  314. to each agent and group registered."
  315. INDEX { AgentIndex, GroupIndex }
  316. ::= { contentsTable  1 }
  317.  
  318. ContentsEntry         ::= SEQUENCE {
  319. contentsAgent        MacintoshDisplayString,
  320. contentsGroup        MacintoshDisplayString,
  321. contentsObjectID    OBJECT IDENTIFIER
  322. }
  323.  
  324. contentsAgent  OBJECT-TYPE
  325. SYNTAX     MacintoshDisplayString
  326. ACCESS    read-only
  327. STATUS    mandatory
  328. DESCRIPTION
  329. "The name of the agent owning this group." 
  330. ::= { contentsEntry 1 }
  331.  
  332. contentsGroup  OBJECT-TYPE
  333. SYNTAX     MacintoshDisplayString
  334. ACCESS    read-only
  335. STATUS    mandatory
  336. DESCRIPTION
  337. "The name of the group." 
  338. ::= { contentsEntry 2 }
  339.  
  340. contentsObjectID     OBJECT-TYPE
  341. SYNTAX     OBJECT IDENTIFIER
  342. ACCESS    read-only
  343. STATUS    mandatory
  344. DESCRIPTION
  345. "The object ID of the group."
  346. ::= { contentsEntry 3 }
  347.  
  348. trapTable   OBJECT-TYPE
  349. SYNTAX  SEQUENCE OF TrapRequestEntry
  350. ACCESS  not-accessible
  351. STATUS  mandatory
  352. DESCRIPTION
  353. "Contains a list of all the consoles that traps will be sent 
  354. to."
  355. ::= { system 7 }
  356.  
  357. trapRequestEntry     OBJECT-TYPE
  358. SYNTAX  TrapRequestEntry
  359. ACCESS  not-accessible
  360. STATUS  mandatory
  361. DESCRIPTION
  362. "Each entry contains a complete description of a trap's 
  363. destination." 
  364. INDEX { trapIndex }
  365. ::= { trapTable 1 }
  366.  
  367. TrapRequestEntry     ::= SEQUENCE {
  368. trapIndex        INTEGER,
  369. trapCommunity    MacintoshDisplayString,
  370. trapProtocol    MacintoshDisplayString,
  371. trapDestination    OCTET STRING,
  372. trapValidity    INTEGER
  373. }
  374.  
  375. trapIndex  OBJECT-TYPE
  376. SYNTAX  INTEGER
  377. ACCESS  read-only
  378. STATUS  mandatory
  379. DESCRIPTION
  380. "The index into the trapTable."
  381. ::= { trapRequestEntry 1 }
  382.  
  383. trapCommunity  OBJECT-TYPE
  384. SYNTAX  MacintoshDisplayString
  385. ACCESS  read-write
  386. STATUS  mandatory
  387. DESCRIPTION
  388. "The community that must be associated with the trap."
  389. ::= { trapRequestEntry 2 }
  390.  
  391. trapProtocol  OBJECT-TYPE
  392. SYNTAX  MacintoshDisplayString
  393. ACCESS  read-write
  394. STATUS  mandatory
  395. DESCRIPTION
  396. "The identifier of the protocol that the trap must use. For IP 
  397. this is 'UDP ', for AppleTalk this is 'DDP ', etc." 
  398. REFERENCE
  399. "See 'MacSNMP Programmer's Guide.'" 
  400. ::= { trapRequestEntry 3 }
  401.  
  402. trapDestination  OBJECT-TYPE
  403. SYNTAX  OCTET STRING
  404. ACCESS  read-write
  405. STATUS  mandatory
  406. DESCRIPTION
  407. "Where to send a trap. This information is different for each 
  408. protocol. For TCP/IP the IP address in dotted decimal notation 
  409. is used; for AppleTalk the NBP name of the console is used."
  410. REFERENCE
  411. "See 'MacSNMP Administrator's Guide.'" 
  412. ::= { trapRequestEntry 4 }
  413.  
  414. trapValidity  OBJECT-TYPE
  415. SYNTAX  INTEGER {
  416. valid(1),
  417. invalid(2)
  418. }
  419. ACCESS  read-write
  420. STATUS  mandatory
  421. DESCRIPTION
  422. "This entry defines whether the row is still active and valid."
  423. ::= { trapRequestEntry 5 }
  424.  
  425.  
  426. -- The Software Group
  427.     
  428.     
  429. gestaltTable  OBJECT-TYPE
  430. SYNTAX     SEQUENCE OF GestaltEntry
  431. ACCESS    not-accessible
  432. STATUS    mandatory
  433. DESCRIPTION
  434. "Contains the results from the Gestalt call. Some interesting 
  435. Gestalt selectors are 'ram ' for bytes of physical RAM, 'romv' 
  436. for ROM version, 'sysv' for system version, and 'atlk' for 
  437. AppleTalk version."
  438. REFERENCE
  439. "See 'Inside Macintosh' Vol. VI, Ch. 3."
  440. ::= { software 1 }
  441.  
  442. gestaltEntry  OBJECT-TYPE
  443. SYNTAX     GestaltEntry
  444. ACCESS    not-accessible
  445. STATUS    mandatory
  446. DESCRIPTION
  447. "Each entry contains the Gestalt selector, the response, and 
  448. the response type." 
  449. INDEX { gestaltSelector }
  450. ::= { gestaltTable 1 }
  451.  
  452. GestaltEntry         ::= SEQUENCE {
  453. gestaltSelector        MacOSType,
  454. gestaltResponseType    INTEGER,
  455. gestaltResponse        OCTET STRING (SIZE (4))
  456. }
  457.  
  458. gestaltSelector  OBJECT-TYPE
  459. SYNTAX     MacOSType
  460. ACCESS    read-only
  461. STATUS    mandatory
  462. DESCRIPTION
  463. "A four-octet string that determines what information you want. 
  464. It usually consists of ASCII characters."
  465. ::= { gestaltEntry 1 }
  466.  
  467. gestaltResponseType     OBJECT-TYPE
  468. SYNTAX     INTEGER {
  469.         other(1),
  470.         unknown(2),
  471.         attr(3),
  472.         count(4),
  473.         size(5),
  474.         table(6),
  475.         type(7),
  476.         version(8)
  477. }
  478. ACCESS    read-only
  479. STATUS    mandatory
  480. DESCRIPTION
  481. "How to interpret the Gestalt response: Attr is a bit field; 
  482. Count is how many of the type exist; Size is usually in bytes; 
  483. Table is the memory address of a table; Version is in binary-
  484. coded decimal."
  485. REFERENCE
  486. "See 'Inside Macintosh' Vol. VI, Ch. 3."
  487. ::= { gestaltEntry 2 }
  488.  
  489. gestaltResponse  OBJECT-TYPE
  490. SYNTAX     OCTET STRING (SIZE (4))
  491. ACCESS    read-only
  492. STATUS    mandatory
  493. DESCRIPTION
  494. "The information you requested. Its interpretation depends on 
  495. the corresponding Gestalt type."
  496. ::= { gestaltEntry 3 }
  497.  
  498. printerName  OBJECT-TYPE
  499. SYNTAX     MacintoshDisplayString  (SIZE (0..31))
  500. ACCESS    read-only
  501. STATUS    mandatory
  502. DESCRIPTION
  503. "The name of the printer currently chosen."
  504. ::= { software 2 }
  505.  
  506. printerZone  OBJECT-TYPE
  507. SYNTAX     MacintoshDisplayString (SIZE (0..31))
  508. ACCESS    read-only
  509. STATUS    mandatory
  510. DESCRIPTION
  511. "The zone of the printer currently chosen."
  512. ::= { software 3 }
  513.  
  514. printerType  OBJECT-TYPE
  515. SYNTAX     MacintoshDisplayString (SIZE (0..31))
  516. ACCESS    read-only
  517. STATUS    mandatory
  518. DESCRIPTION
  519. "The name of the printer driver currently chosen."
  520. ::= { software 4 }
  521.  
  522. systemFilesTable      OBJECT-TYPE
  523. SYNTAX     SEQUENCE OF FileEntry
  524. ACCESS    not-accessible
  525. STATUS    mandatory
  526. DESCRIPTION
  527. "Contains a list of all the files in the active System Folder 
  528. and its subfolders."
  529. ::= { software 5 }
  530.  
  531. fileEntry  OBJECT-TYPE
  532. SYNTAX     FileEntry
  533. ACCESS    not-accessible
  534. STATUS    mandatory
  535. DESCRIPTION
  536. "Each entry contains a complete description of a file and its 
  537. location. The index starts at one and increments by one for 
  538. each file." 
  539. INDEX { INTEGER }
  540. ::= { systemFilesTable 1 }
  541.  
  542. FileEntry         ::= SEQUENCE {
  543. fileName        MacintoshDisplayString,
  544. fileCreator        MacOSType,
  545. fileSize        INTEGER,
  546. fileCreateDate     MacDate,
  547. fileModDate        MacDate,
  548. fileVersion        MacintoshDisplayString,
  549. fileDirName        MacintoshDisplayString,
  550. fileType        MacOSType
  551. }
  552.  
  553. fileName  OBJECT-TYPE
  554. SYNTAX     MacintoshDisplayString
  555. ACCESS    read-only
  556. STATUS    mandatory
  557. DESCRIPTION
  558. "The name of the file. The ASCII character for the colon (:) is 
  559. not allowed."
  560. ::= { fileEntry 1 }
  561.  
  562. fileCreator  OBJECT-TYPE
  563. SYNTAX     MacOSType
  564. ACCESS    read-only
  565. STATUS    mandatory
  566. DESCRIPTION
  567. "The creator of the file. A four-character string that is 
  568. usually in ASCII."
  569. ::= { fileEntry 2  }
  570.  
  571. fileSize  OBJECT-TYPE
  572. SYNTAX     INTEGER
  573. ACCESS    read-only
  574. STATUS    mandatory
  575. DESCRIPTION
  576. "The size of the file in bytes."
  577. ::= { fileEntry 3  }
  578.  
  579. fileCreateDate  OBJECT-TYPE
  580. SYNTAX     MacDate
  581. ACCESS    read-only
  582. STATUS    mandatory
  583. DESCRIPTION
  584. "The creation date of the file in seconds from midnight, 
  585. January 1, 1904."
  586. ::= { fileEntry 4  }
  587.  
  588. fileModDate  OBJECT-TYPE
  589. SYNTAX     MacDate
  590. ACCESS    read-only
  591. STATUS    mandatory
  592. DESCRIPTION
  593. "The modification date of the file in seconds from midnight, 
  594. January 1, 1904."
  595. ::= { fileEntry 5  }
  596.  
  597. fileVersion  OBJECT-TYPE
  598. SYNTAX     MacintoshDisplayString
  599. ACCESS    read-only
  600. STATUS    mandatory
  601. DESCRIPTION
  602. "The version of the application."
  603. REFERENCE
  604. "See 'Inside Macintosh' Vol. III, Ch. 1." 
  605. ::= { fileEntry 6  }
  606.  
  607. fileDirName  OBJECT-TYPE
  608. SYNTAX     MacintoshDisplayString
  609. ACCESS    read-only
  610. STATUS    mandatory
  611. DESCRIPTION
  612. "The name of the directory the file is in. The ASCII character 
  613. for the colon (:) is not allowed."
  614. ::= { fileEntry 7 }
  615.  
  616. fileType  OBJECT-TYPE
  617. SYNTAX     MacOSType
  618. ACCESS    read-only
  619. STATUS    mandatory
  620. DESCRIPTION
  621. "The type of the file. A four-character string that is usually 
  622. in ASCII."
  623. ::= { fileEntry 8 }
  624.  
  625. applicationFilesTable        OBJECT-TYPE
  626. SYNTAX     SEQUENCE OF ApplEntry
  627. ACCESS    not-accessible
  628. STATUS    mandatory
  629. DESCRIPTION
  630. "Contains a list of all the applications on the local volumes."
  631. ::= { software 6 }
  632.  
  633. applEntry  OBJECT-TYPE
  634. SYNTAX    ApplEntry
  635. ACCESS    not-accessible
  636. STATUS    mandatory
  637. DESCRIPTION
  638. "Each entry contains a complete description of a file and where 
  639. it is. The second index starts at one and is incremented by one 
  640. for each file. The VolRefNum is from the volumeTable."
  641. INDEX { volRefNum, INTEGER }
  642. ::= { applicationFilesTable 1 }
  643.  
  644. ApplEntry         ::= SEQUENCE {
  645. applName        MacintoshDisplayString,
  646. applCreator        MacOSType,
  647. applSize        INTEGER,
  648. applCreateDate     MacDate,
  649. applModDate        MacDate,
  650. applVersion        MacintoshDisplayString
  651. }
  652.  
  653. applName  OBJECT-TYPE
  654. SYNTAX     MacintoshDisplayString
  655. ACCESS    read-only
  656. STATUS    mandatory
  657. DESCRIPTION
  658. "The name of the application."
  659. ::= { applEntry 1 }
  660.  
  661. applCreator  OBJECT-TYPE
  662. SYNTAX     MacOSType
  663. ACCESS    read-only
  664. STATUS    mandatory
  665. DESCRIPTION
  666. "The creator of the application. A four-character string that 
  667. is usually in ASCII."
  668. ::= { applEntry 2  }
  669.  
  670. applSize  OBJECT-TYPE
  671. SYNTAX     INTEGER
  672. ACCESS    read-only
  673. STATUS    mandatory
  674. DESCRIPTION
  675. "The size of the application in bytes."
  676. ::= { applEntry 3  }
  677.  
  678. applCreateDate  OBJECT-TYPE
  679. SYNTAX     MacDate
  680. ACCESS    read-only
  681. STATUS    mandatory
  682. DESCRIPTION
  683. "The creation date of the application in seconds from midnight, 
  684. January 1, 1904."
  685. ::= { applEntry 4  }
  686.  
  687. applModDate  OBJECT-TYPE
  688. SYNTAX     MacDate
  689. ACCESS    read-only
  690. STATUS    mandatory
  691. DESCRIPTION
  692. "The modification date of the application in seconds from 
  693. midnight, January 1, 1904."
  694. ::= { applEntry 5  }
  695.  
  696. applVersion  OBJECT-TYPE
  697. SYNTAX     MacintoshDisplayString
  698. ACCESS    read-only
  699. STATUS    mandatory
  700. DESCRIPTION
  701. "The version of the application." 
  702. REFERENCE
  703. "See 'Inside Macintosh' Vol. III, Ch.1." 
  704. ::= { applEntry 6  }
  705.  
  706.  
  707. -- The Hardware Group
  708.  
  709. nuBusTable  OBJECT-TYPE
  710. SYNTAX     SEQUENCE OF NuBusEntry
  711. ACCESS    not-accessible
  712. STATUS    mandatory
  713. DESCRIPTION
  714. "Contains a list of all the NuBus cards contained in the 
  715. Macintosh." 
  716. REFERENCE
  717. "NuBus is a trademark of Texas Instruments."
  718. ::= { hardware 1 }
  719.  
  720. nuBusEntry  OBJECT-TYPE
  721. SYNTAX     NuBusEntry
  722. ACCESS    not-accessible
  723. STATUS    mandatory
  724. DESCRIPTION
  725. "Each entry contains a complete description of a NuBus card." 
  726. REFERENCE
  727. "See 'Designing Cards and Drivers for the Macintosh II and the 
  728. Macintosh SE,' Chapter 8, Addison-Wesley Publishing Company, 
  729. Inc., 1987."
  730. INDEX { nuBusSlot}
  731. ::= { nuBusTable 1 }
  732.  
  733. NuBusEntry         ::= SEQUENCE {
  734. nuBusSlot            INTEGER,
  735. nuBusType            INTEGER,
  736. nuBusBoardID        INTEGER,
  737. nuBusBoardName        MacintoshDisplayString,
  738. nuBusVendorName        MacintoshDisplayString,
  739. nuBusPartNumber        MacintoshDisplayString,
  740. nuBusSerialNumber    MacintoshDisplayString,
  741. nuBusRevNumber        MacintoshDisplayString,    
  742. nuBusRevDate        MacintoshDisplayString
  743. }
  744.  
  745. nuBusSlot  OBJECT-TYPE
  746. SYNTAX     INTEGER
  747. ACCESS    read-only
  748. STATUS    mandatory
  749. DESCRIPTION
  750. "The slot number of the board."
  751. ::= { nuBusEntry 1  }
  752.  
  753. nuBusType  OBJECT-TYPE
  754. SYNTAX     INTEGER
  755. ACCESS    read-only
  756. STATUS    mandatory
  757. DESCRIPTION
  758. "The category and cType of the board."
  759. ::= { nuBusEntry 2  }
  760.  
  761. nuBusBoardID     OBJECT-TYPE
  762. SYNTAX     INTEGER
  763. ACCESS    read-only
  764. STATUS    mandatory
  765. DESCRIPTION
  766. "The ID of the board."
  767. ::= { nuBusEntry 3  }
  768.  
  769. nuBusBoardName     OBJECT-TYPE
  770. SYNTAX     MacintoshDisplayString
  771. ACCESS    read-only
  772. STATUS    mandatory
  773. DESCRIPTION
  774. "The name of the board."
  775. ::= { nuBusEntry 4  }
  776.  
  777. nuBusVendorName     OBJECT-TYPE
  778. SYNTAX     MacintoshDisplayString
  779. ACCESS    read-only
  780. STATUS    mandatory
  781. DESCRIPTION
  782. "The name of the vendor."
  783. ::= { nuBusEntry 5  }
  784.  
  785. nuBusPartNumber     OBJECT-TYPE
  786. SYNTAX     MacintoshDisplayString
  787. ACCESS    read-only
  788. STATUS    mandatory
  789. DESCRIPTION
  790. "The part number of the board."
  791. ::= { nuBusEntry 6  }
  792.  
  793. nuBusSerialNumber     OBJECT-TYPE
  794. SYNTAX     MacintoshDisplayString
  795. ACCESS    read-only
  796. STATUS    mandatory
  797. DESCRIPTION
  798. "The serial number of the board."
  799. ::= { nuBusEntry 7  }
  800.  
  801. nuBusRevNumber     OBJECT-TYPE
  802. SYNTAX     MacintoshDisplayString
  803. ACCESS    read-only
  804. STATUS    mandatory
  805. DESCRIPTION
  806. "The revision number of the board."
  807. ::= { nuBusEntry 8  }
  808.  
  809. nuBusRevDate     OBJECT-TYPE
  810. SYNTAX     MacintoshDisplayString
  811. ACCESS    read-only
  812. STATUS    mandatory
  813. DESCRIPTION
  814. "The revision date of the board."
  815. ::= { nuBusEntry 9  }
  816.  
  817. scsiTable  OBJECT-TYPE
  818. SYNTAX     SEQUENCE OF SCSIEntry
  819. ACCESS    not-accessible
  820. STATUS    mandatory
  821. DESCRIPTION
  822. "Contains a list of all the SCSI devices in the Macintosh."
  823. ::= { hardware 2 }
  824.  
  825. scsiEntry   OBJECT-TYPE
  826. SYNTAX     SCSIEntry
  827. ACCESS    not-accessible
  828. STATUS    mandatory
  829. DESCRIPTION
  830. "Each entry contains a complete description of a SCSI device. 
  831. The index is equal to the scsiID + 1." 
  832. INDEX { INTEGER }
  833. ::= { scsiTable 1 }
  834.  
  835. SCSIEntry         ::= SEQUENCE {
  836. scsiID            INTEGER,
  837. scsiType        MacintoshDisplayString,
  838. scsiVendor        MacintoshDisplayString,
  839. scsiProduct        MacintoshDisplayString,
  840. scsiVersion        MacintoshDisplayString
  841. }
  842.  
  843. scsiID OBJECT-TYPE
  844. SYNTAX     INTEGER
  845. ACCESS    read-only
  846. STATUS    mandatory
  847. DESCRIPTION
  848. "The bus ID of the SCSI device."
  849. ::= { scsiEntry 1  }
  850.  
  851. scsiType OBJECT-TYPE
  852. SYNTAX     MacintoshDisplayString
  853. ACCESS    read-only
  854. STATUS    mandatory
  855. DESCRIPTION
  856. "The type of the SCSI device."
  857. ::= { scsiEntry 2  }
  858.  
  859. scsiVendor  OBJECT-TYPE
  860. SYNTAX     MacintoshDisplayString
  861. ACCESS    read-only
  862. STATUS    mandatory
  863. DESCRIPTION
  864. "The vendor of the SCSI device."
  865. ::= { scsiEntry 3  }
  866.  
  867. scsiProduct  OBJECT-TYPE
  868. SYNTAX     MacintoshDisplayString
  869. ACCESS    read-only
  870. STATUS    mandatory
  871. DESCRIPTION
  872. "The product name of the SCSI device."
  873. ::= { scsiEntry 4  }
  874.  
  875. scsiVersion  OBJECT-TYPE
  876. SYNTAX     MacintoshDisplayString
  877. ACCESS    read-only
  878. STATUS    mandatory
  879. DESCRIPTION
  880. "The version of the SCSI device."
  881. ::= { scsiEntry 5  }
  882.  
  883. volumeTable   OBJECT-TYPE
  884. SYNTAX     SEQUENCE OF VolumeEntry
  885. ACCESS    not-accessible
  886. STATUS    mandatory
  887. DESCRIPTION
  888. "Contains a list of all the volumes directly connected to the 
  889. Macintosh."
  890. ::= { hardware 3 }
  891.  
  892. volumeEntry  OBJECT-TYPE
  893. SYNTAX     VolumeEntry
  894. ACCESS    not-accessible
  895. STATUS    mandatory
  896. DESCRIPTION
  897. "Each entry contains a complete description of a volume." 
  898. INDEX { volRefNum }
  899. ::= { volumeTable 1 }
  900.  
  901. VolumeEntry         ::= SEQUENCE {
  902. volRefNum        INTEGER,
  903. volName            MacintoshDisplayString,
  904. volKind            MacintoshDisplayString,
  905. volLocation        MacintoshDisplayString,
  906. volBytesUsed    Counter,
  907. volBytesFree    Counter
  908. }
  909.  
  910. volRefNum  OBJECT-TYPE
  911. SYNTAX     INTEGER
  912. ACCESS    read-only
  913. STATUS    mandatory
  914. DESCRIPTION
  915. "The reference number of the volume. Usually a negative 
  916. number."
  917. ::= { volumeEntry 1  }
  918.  
  919. volName  OBJECT-TYPE
  920. SYNTAX     MacintoshDisplayString
  921. ACCESS    read-only
  922. STATUS    mandatory
  923. DESCRIPTION
  924. "The name of the volume."
  925. ::= { volumeEntry 2  }
  926.  
  927. volKind  OBJECT-TYPE
  928. SYNTAX     MacintoshDisplayString
  929. ACCESS    read-only
  930. STATUS    mandatory
  931. DESCRIPTION
  932. "The kind of volume."
  933. ::= { volumeEntry 3  }
  934.  
  935. volLocation  OBJECT-TYPE
  936. SYNTAX     MacintoshDisplayString
  937. ACCESS    read-only
  938. STATUS    mandatory
  939. DESCRIPTION
  940. "The location of the volume."
  941. ::= { volumeEntry 4  }
  942.  
  943. volBytesUsed  OBJECT-TYPE
  944. SYNTAX     Counter
  945. ACCESS    read-only
  946. STATUS    mandatory
  947. DESCRIPTION
  948. "The number of bytes used on the volume."
  949. ::= { volumeEntry 5  }
  950.  
  951. volBytesFree  OBJECT-TYPE
  952. SYNTAX     Counter
  953. ACCESS    read-only
  954. STATUS    mandatory
  955. DESCRIPTION
  956. "The number of bytes free on the volume."
  957. ::= { volumeEntry 6  }
  958.  
  959. END
  960.  
  961.  
  962. 7. Acknowledgments
  963.  
  964. The Apple-IP Working Group was instrumental in defining this document. 
  965. Their support and work were greatly appreciated.
  966.  
  967.  
  968.  
  969. 8. References
  970.  
  971. [1]  Rose, M.T., and K. McCloghrie, "Structure and Identification of 
  972. Management Information for TCP/IP-Based Internets," Internet 
  973. Working Group Request for Comments 1155, Network Information 
  974. Center, SRI International, Menlo Park, California, May 1990.
  975.  
  976. [2]  McCloghrie, K., and M.T. Rose, "Management Information Base for 
  977. Network Management of TCP/IP-Based Internets," Internet Working 
  978. Group Request for Comments 1213, Network Information Center, SRI 
  979. International, Menlo Park, California, May 1990.
  980.  
  981. [3]  Case, J.D., M.S. Fedor, M.L. Schoffstall, and J.R. Davin, 
  982. "Simple Network Management Protocol," Internet Working Group 
  983. Request for Comments 1157, Network Information Center, SRI 
  984. International, Menlo Park, California, May 1990.
  985.  
  986. [4]  Rose, M.T., and K. McCloghrie, Editors, "Towards Concise MIB 
  987. Definitions," Internet Draft, Internet Engineering Task Force, 
  988. September 1990.
  989.  
  990. [5]  M. Rose, Editor, "A Convention for Defining Traps
  991. for Use With the SNMP," Internet Working Group Request for 
  992. Comments 1158, Network Information Center, SRI International, 
  993. Menlo Park, California, March 1991. 
  994.  
  995. [6]  Sidhu, Gursharan S., Richard F. Andrews, and Alan B. 
  996. Oppenheimer, "Inside AppleTalk," second edition, Addison-Wesley 
  997. Publishing Company, Inc., 1991.
  998.  
  999. [7]  "Apple Multivendor Network Solutions Guide," Apple Computer, 
  1000. Inc., 1990.
  1001.  
  1002. [8]  Postel, J.B., and J.K. Reynolds, "Telnet Protocol 
  1003. specification," Internet Working Group Request for Comments 854, 
  1004. Network Information Center, SRI International, Menlo Park, 
  1005. California, May 1983.
  1006.  
  1007. [9]  "Inside Macintosh," Volumes I - VI, Addison-Wesley Publishing 
  1008. Company, Inc., 1985-1991.
  1009.  
  1010. 9. Author's address 
  1011.  
  1012. Mike Ritter
  1013. Apple Computer, Inc.
  1014. 10500 North De Anza Boulevard, MS-35K
  1015. Cupertino, California 95014
  1016.  
  1017. Phone:  408-862-8088
  1018. Fax:    408-862-1159
  1019. EMail:  MWRITTER@applelink.apple.com    
  1020.  
  1021. Ritter  IETF Draft: Macintosh System MIB expires 22 July 1993
  1022.  
  1023. Vincent Lubet
  1024. Apple Computer, Inc.
  1025. 2 Infinite Loop, MS 302-3K
  1026. Cupertino, California 95014
  1027.  
  1028. EMail: lubet1@applelink.apple.com
  1029.